package org.dromara.exam.service;

import org.dromara.common.mybatis.core.page.PageQuery;
import org.dromara.common.mybatis.core.page.TableDataInfo;
import org.dromara.exam.domain.bo.*;
import org.dromara.exam.domain.dto.TemplateCount;
import org.dromara.exam.domain.dto.TemplateImport;
import org.dromara.exam.domain.dto.TemplateTypeCount;
import org.dromara.exam.domain.entity.ExamTemplate;
import org.dromara.exam.domain.vo.ExamTemplateVo;

import java.util.Collection;
import java.util.List;

/**
 * 题目Service接口
 *
 * @author xiyin321
 * @date 2024-04-11
 */
public interface IExamTemplateService {

    /**
     * 根据ID查询题目详情
     *
     * @param templateId 题目ID
     * @return 题目视图对象
     */
    ExamTemplateVo queryById(Long templateId);

    /**
     * 根据ID批量查询题目列表
     *
     * @param templateIds 题目ID数组
     * @return 题目视图对象列表
     */
    List<ExamTemplateVo> queryListByIds(Long[] templateIds);

    /**
     * 分页查询题目列表
     *
     * @param bo        查询条件对象
     * @param pageQuery 分页参数
     * @return 分页结果对象
     */
    TableDataInfo<ExamTemplateVo> queryPage(ExamTemplateBo bo, PageQuery pageQuery);

    /**
     * 查询题目列表
     *
     * @param bo 查询条件对象
     * @return 题目视图对象列表
     */
    List<ExamTemplateVo> queryList(ExamTemplateBo bo);

    /**
     * 从题库中挑选题目
     *
     * @param repoId        题库ID
     * @param questionTypes 题目类型列表
     * @param tags          标签列表
     * @return 题目视图对象列表
     */
    List<ExamTemplateVo> pickTemplateList(Long repoId, List<String> questionTypes, List<String> tags);

    /**
     * 根据题库ID列表查询题库题目统计
     *
     * @param repoIds 题库ID列表
     * @return 题目统计对象
     */
    List<TemplateCount> queryTemplateCounts(List<Long> repoIds);

    /**
     * 查询题库题目统计汇总
     *
     * @param repoId 题库ID
     * @return 题目统计汇总对象
     */
//    TemplateCount queryTemplateCount(Long repoId);

    /**
     * 根据题库ID列表查询题库题目类型统计
     *
     * @param repoIds 题库ID列表
     * @return 题目类型统计对象
     */
    List<TemplateTypeCount>queryTemplateTypeCounts(List<Long> repoIds);

    /**
     * 根据题库ID查询题目数量
     *
     * @param repoId 题库ID
     * @return 题目数量
     */
    Long queryTemplateCountByRepoId(Long repoId);

    /**
     * 检查题库是否存在关联的模板
     *
     * @param repoId 题库ID
     * @return Boolean
     */
    Boolean checkRepoExistTemplate(List<Long> repoId);

    /**
     * 新增题目
     *
     * @param bo 题目业务对象
     * @return 操作结果
     */
    Boolean insertByBo(ExamTemplateBo bo);

    /**
     * 批量新增或更新题目
     *
     * @param templates 题目集合
     */
    void batchInsertOrUpdate(Collection<ExamTemplate> templates);

    /**
     * 导入题目模板
     *
     * @param bo 题目导入业务对象
     */
    void importTemplate(ExamTemplateImportBo bo);

    /**
     * 通过excel导入题目到编辑界面
     *
     * @param bo 题目导入业务对象
     */
    List<TemplateImport> importTemplateToEdit(ExamTemplateImportBo bo);

    /**
     * 生成题目列表
     *
     * @param bo 题目生成业务对象
     * @return 异步结果包含题目大纲列表
     */
    List<ExamTemplateVo> generateQuestionList(QuestionGenerateBo bo);

    /**
     * 更新题目信息
     *
     * @param bo 题目业务对象
     * @return 操作结果
     */
    Boolean updateByBo(ExamTemplateBo bo);

    /**
     * 批量更新题目模板（新增或修改）
     *
     * @param bo 题目更新业务对象
     * @return 操作结果
     */
    Boolean batchUpdateQuestionTemplate(ExamTemplateUpdateBo bo);

    /**
     * 批量删除题目（带校验）
     *
     * @param ids     主键集合
     * @param isValid 是否进行关联校验
     * @return 操作结果
     */
    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);

    /**
     * 根据题库ID批量删除题目
     *
     * @param repoIds 题库ID列表
     * @return 操作结果
     */
    Boolean deleteBatchByRepoIds(List<Long> repoIds);
}
